home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 25 / Cream of the Crop 25.iso / utility / bfind704.zip / BRUCE.DOC < prev    next >
Text File  |  1997-04-30  |  15KB  |  272 lines
  1. BRUCE.DOC                              1                           Apr 30, 1997
  2.  
  3. -------------------------------------------------------------------------------
  4.                                   Introduction
  5.  
  6. This documentation provides some overview information on a number of utilities.
  7. All programs  described  herein  were  written  by  Bruce  Guthrie.   Most  are
  8. distributed with a Wayne Software copyright.  Others were written for the  U.S.
  9. Department of Commerce.
  10.  
  11. All programs are free for use provided relevant documentation is kept with  the
  12. programs, no changes are made to the programs or documentation,  and  they  are
  13. not bundled with commercial programs or charged for separately.
  14.  
  15. CHANGE,  CONVERT,  FILUPDAT,  READ,   and   READY   are   excluded   from   the
  16. commercial-packaging  restriction.   These  programs  are  owned  by  the  U.S.
  17. Department of Commerce and may be re-distributed without restriction.
  18.  
  19. People who need to  bundle  AV,  BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  20. EUMAIL, FILL, FIXTEXT, FORTUNE, HTMSTRIP, MOZ, PAGINATE, READINIT,  or  TXTABLE
  21. in commercial packages other than shareware/freeware collections must pay a $50
  22. registration fee to "Wayne Software" at the following address. READMAKE-created
  23. files are also subject to this limitation.  I don't expect to  make  any  money
  24. from  these  utilities  but  I  don't  want  others  to  sell   them   instead.
  25. Shareware-distribution groups that charge more than $7 for a  diskette  or  $20
  26. for a CD-ROM are, as far as I'm concerned, making excessive profits from  these
  27. programs--their actual costs are way below this--and  probably  keeping  people
  28. from registering the other shareware on the disk; I do not want these types  of
  29. places distributing my programs.
  30.  
  31. This collection of utilities were compiled using Microsoft's Visual  BASIC  for
  32. DOS 1.0 compiler in addition  to  Thomas  G.  Hanlin  III's  excellent  PBClone
  33. routines.  Since DOS compilers and libraries  are  not  being  maintained  much
  34. anymore, adding new data formats and such may not be possible.  Since they  are
  35. DOS-based, forget long Win95 and WinNT file names and such.
  36.  
  37. Documentation provided in appropriate ZIP files:
  38.  routine.DOC:   Each utility is separately  described  in  a  like-named  *.DOC
  39.                 file.
  40.  FILE_ID.DIZ:   Standard "Description In Zip" file.
  41.  BRUCE.DOC:     This file serves to summarize all of the various utilities.
  42.  BRUCEINI.DOC:  Most of the routines have defaults that can  altered  by  using
  43.                 initialization files (inifiles).  These are referenced  in  the
  44.                 regular documentation and further described here.
  45.  BRUCEHEX.DOC:  Many of the routines allow you to enter  parameters  as  either
  46.                 hexadecimal or decimal strings.   This  is  referenced  in  the
  47.                 regular documentation and further described here.
  48.  HISTORY.ymm:   List of  recent  modifications  to  all  programs.   The  "ymm"
  49.                 indicates the release date in year/month format.   "601"  means
  50.                 1996, first month (Jan 1996).
  51.  
  52. All program documentation was created using a text editor (PE2).  The  PAGINATE
  53. command (see below) was used to  justify  the  text  and  create  titles,  page
  54. breaks, and (where provided) indexes.
  55.  
  56.  
  57. BRUCE.DOC                              2                           Apr 30, 1997
  58.  
  59. -------------------------------------------------------------------------------
  60.                               Contact information
  61.  
  62. For the following routines:  AV, BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  63. EUMAIL,  FILL,   FIXTEXT,   FORTUNE,   HTMSTRIP,   MOZ,   PAGINATE,   READINIT,
  64. READMAKE-created files, and TXTABLE:
  65.  
  66.                 Bruce Guthrie
  67.                 Wayne Software
  68.                 113 Sheffield St.
  69.                 Silver Spring, MD 20910
  70.  
  71.                 fax: (301) 588-8986
  72.                 e-mail: bguthrie@nmaa.org
  73.                 http://www.geocities.com/SiliconValley/Lakes/2414
  74.  
  75. For the following routines:  CHANGE, CONVERT, FILUPDAT, READ, and READY:
  76.  
  77.                 Bruce Guthrie
  78.                 Room H-4885
  79.                 U.S. Dept of Commerce/ESA/STAT-USA
  80.                 Washington, DC 20230
  81.  
  82.                 fax: (202) 482-2164
  83.                 voice: (202) 482-3234
  84.                 e-mail: bguthrie@doc.gov
  85.  
  86. Please provide an Internet e-mail address on all correspondence.
  87.  
  88. Since these programs are typically "freeware" (with  the  exception  of  people
  89. trying to make money from them instead of me), they generate maybe $100/year in
  90. revenue for me.  As such, my ability to afford wonderful  customer  support  is
  91. somewhat restricted.  Please  do  not  leave  messages  saying  "Call  me  long
  92. distance".  Also, please be specific about  what  problems  you  encounter  and
  93. include command-line inputs as well as any control or  INI  files  that  you're
  94. using.
  95.  
  96. Beta testers and suggestions are always appreciated.  Among other things,  beta
  97. testers receive e-mail  notification  whenever  major  enhancements  are  made.
  98. Contact me at bguthrie@nmaa.org Note that all beta releases are done via e-mail
  99. so if  your  gateway  can't  handle  some  pretty  big  mail  attachments,  you
  100. definitely do NOT want to be a beta tester for me!  Modifications that are  not
  101. of mainstream use can be contracted for.
  102.  
  103. WIN/NT AND WIN95 USERS:  All of these  programs  are  DOS  applications.   This
  104. means that they expect 8.3 filenames, short paths, etc.  If you use long  paths
  105. or illegal characters in your file names or whatever, these  programs  may  not
  106. work for you.  This is not a "bug" in the software.  That's just  the  way  DOS
  107. programs are.
  108.  
  109. STANDARD LEGAL DISCLAIMER:  Wayne Software disclaims all warranties as to  this
  110. software, whether express or implied, including without limitation any  implied
  111. warranties of merchantability, fitness for a particular purpose, functionality,
  112. data integrity or protection.
  113.  
  114.  
  115. BRUCE.DOC                              3                           Apr 30, 1997
  116.  
  117. -------------------------------------------------------------------------------
  118.            Finding the programs--Current version is 704 (1997 April)
  119.  
  120. The utilities are uploaded with a ZIP name that includes the year and month  of
  121. the release in a "ymm" format (mm-number month where 01=January, and  199y  for
  122. year).  The files are posted directly by  the  author  to  three  places.   The
  123. following Web site has the current versions of *all* programs:
  124.  
  125.                 http://www.geocities.com/SiliconValley/Lakes/2414
  126.  
  127. Major revisions are directly posted by the author to the following:
  128. * Simtel (Coast-To-Coast): ftp.coast.net (http://www.coast.net/Simtel)
  129. * Simtel (Keith Petersen): ftp.simtel.net (http://www.simtel.net/simtel.net)
  130. * ZDI Software Library:  Ziff-Davis is provided notice of updates although
  131. I'm not sure how long it takes them to update them on their Web site.
  132.  
  133.                          Simtel locations and versions
  134.  
  135. http://www.coast.net/SimTel/msdos/      ftp://ftp.simtel.net/simtelnet/msdos/
  136.   ..arcutil/                            ..arcutils/
  137. av703.zip       Archive View: Free ZIP etc directory viewer
  138.   ..batutil/                            ..batchutl/
  139. dates704.zip    Warns you in advance of birthdays etc
  140. fortn704.zip    Fine-tunes DOS FOR command w/options
  141.   ..dirutil/                            ..dirutl/
  142. cops704.zip     Copies files modified since given date
  143. dirco703.zip    Updates files based on source directory
  144. dirto702.zip    Directory lister and totaller
  145. filup704.zip    Copy updated files based on a control list
  146.   ..diskutil/                           ..diskutil/
  147. fill704.zip     Stuffs as many files as possible on disk
  148.   ..internet/                           ..html/
  149. htmst704.zip    Reprocesses HTML pages for humans to read
  150.   ..offline/                            ..mailnews/
  151. eumal704.zip    Eudora utility for nicknames, boxes
  152.   ..spredsht/                           ..spredsht/
  153. convr704.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  154.   ..textutil/                           ..txtutl/
  155. bfind704.zip    Boolean FIND command (BFIND BEGIN & END)
  156. chang704.zip    Change strings in text/binary files
  157. fixtx704.zip    Translate text file characters en masse
  158. pagin704.zip    Paginates text (indexes, sorts, tables)
  159. read703.zip     Free viewer, also make any text self-viewing
  160. txtab704.zip    Generates text tables
  161.  
  162. If you're using a version of the programs that's more  than  six  month's  old,
  163. it's almost always the case that there's a newer version.  Please check for  an
  164. update.  If you can receive binary attachments, contact me at bguthrie@nmaa.org
  165. for free updates.  Alternatively, send $10 made out to "Wayne Software" to  the
  166. Wayne Software address above and I'll send you everything on diskette.  (If you
  167. need anything other than 3.5" high density, specify that too please.)
  168.  
  169. The versions of each program posted on SimTel are documented below  along  with
  170. the directory information for this  site.   The  *current*  versions  of  *all*
  171. programs are posted on the GeoCities site.
  172.  
  173.  
  174. BRUCE.DOC                              4                           Apr 30, 1997
  175.  
  176. -------------------------------------------------------------------------------
  177.                            Short program descriptions
  178.  
  179. NOTE:  All programs support early termination by pressing Escape.
  180.  
  181. AV.EXE: Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  182.    etc) and lets you sort as desired.  Also allows resetting of the  file  date
  183.    based on the archive's contents.
  184.  
  185. BFIND.EXE: Allows Boolean-type FIND requests.  For example, find any line  with
  186.    one string AND another one, or any line with one string  OR  another.   Also
  187.    allows wildcarded input file names.
  188.  
  189. CHANGE.EXE: Processes change commands in files.  Files can be of any  size  and
  190.    type (binary or text) and  are  processed  quickly.   Up  to  thirty  change
  191.    commands can be processed in a single pass.  Also provides ability to remove
  192.    trailing spaces from text files.
  193.  
  194. CONVERT.EXE: Converts  between  data  formats:   FROM  dBase,   ASCII-delimited
  195.    (typically commas between fields and quotes around strings), and fixed field
  196.    TO Lotus WKS,  ASCII-delimited,  dBase,  and  fixed  field.   Also  provides
  197.    ability to add and drop fields, giving you the ability to crunch tables.
  198.  
  199. COPSINCE.EXE: Copies all files modified since a given date.  Primarily used for
  200.    making sure you have a back-up of files and also to copy updated programs to
  201.    another place.  Lets you define your own groupings of files if desired.
  202.  
  203. DATES.EXE: Program that warns you in advance when an  event  like  a  birthday,
  204.    anniversary, or holiday is coming up.  The  idea  is  to  give  you  advance
  205.    warning so you can send a card or get out of town in time.
  206.  
  207. DIRCOMP.EXE: Similar in some ways to DOS's REPLACE command but adds ability  to
  208.    delete extra files in the destination subdirectory, copy hidden  and  system
  209.    files, and prepare a report showing inconsistencies.  Is frequently used  by
  210.    network administrators to update workstation files.
  211.  
  212. DIRTOTAL.EXE: Prepares report showing files in subdirectory or  drive.   Allows
  213.    restricting search based on date, size, attributes, etc.  Works on networked
  214.    and CD-ROM drives.  Produces more formalized report than some utilities  do.
  215.    Also allows you to look for duplicate file names.
  216.  
  217. EUMAIL.EXE: Eudora mail summarizer.  Dumps your  Qualcomm  Eudora  mailbook  as
  218.    well as summarizing the contents of all of your Eudora boxes and folders.
  219.  
  220. FILL.EXE: Program designed to move files off to floppy  diskettes,  taking  the
  221.    biggest files first and skipping those that won't fit.  Also works fine  for
  222.    transfers to/from DOS-compatible  networks,  removable  drives,  etc.   Also
  223.    supports  splitting  large  files,  creating  a  status  report,  and  other
  224.    features.
  225.  
  226. FILUPDAT.EXE: Program which compares a selected list of files in a source  path
  227.    against those in another path and  copies  those  that  have  been  updated.
  228.    Similar to DOS' REPLACE command but  works  from  a  stored  list  of  files
  229.    (controlled updates) and can handle any number of directories.
  230.  
  231.  
  232. BRUCE.DOC                              5                           Apr 30, 1997
  233.  
  234. FIXTEXT.EXE: Program which applies a user-definable character-translation table
  235.    to a text file.  Can allow you to convert graphics characters to their  text
  236.    equivalents, lowercase letters to uppercase letter, etc.  Can also  be  used
  237.    to translate DOS text files to Mac or Unix text files and vice  versa.   Can
  238.    also expand tabs, remove leading and trailing spaces, remove backspaces, and
  239.    remove blank lines.
  240.  
  241. FORTUNE.EXE: A tuner-upper for the DOS FOR command.   Generates  a  batch  file
  242.    which does all those wildcard things you wished FOR could do (like  "FORTUNE
  243.    IN (*.BAS) DO RENAME %A %2*.*" to remove parts of file names).  Lets you  do
  244.    all sorts of things including distinguishing  file  name  roots  from  their
  245.    extensions as well as incrementing file names by specified values.
  246.  
  247. HTMSTRIP.EXE: Processes and removes  embedded  HTML  commands  from  Web  pages
  248.    downloaded from the Web.   Reflows  paragraphs,  processes  tables,  etc  as
  249.    straight ASCII text.  Can  function  on  individually-saved  pages  or  else
  250.    process your entire disk cache.  Ideal tool  for  resending  via  e-mail  or
  251.    dozens of different uses.  Awarded a "Best"  rating  by  "PC  Computing"  in
  252.    their July 1996 issue. Includes MOZ.EXE which renames the files in your  Web
  253.    cache subdirectory so you can identify them more easily.
  254.  
  255. PAGINATE.EXE: Reformats text files with  embedded  formatting  codes.   Handles
  256.    things like titles, footers, indexes, alignment, justification,  multicolumn
  257.    listings,  etc.   Also  provides  support  for  embedding  tabular  data  in
  258.    ASCII-delimited or dBase formats which can be embedded and/or sorted in your
  259.    reports.
  260.  
  261. READ.EXE, READY.EXE,  READINIT.EXE,  and  READMAKE.EXE:   Text  file   browsing
  262.    utilities.  READ--Supports marking, copying text, reading Unix and Mac  text
  263.    files, etc.  Handles files of 16,000 lines or less (approx  800,000  bytes).
  264.    READY--truncates or wraps lines over 255 characters in  length  but  handles
  265.    files of an unlimited number of lines.  READMAKE--Takes an  ASCII-text  file
  266.    and makes it self-viewable (using a READ clone).
  267.  
  268. TXTABLE.EXE: Program to generate text tables.  Allows inputs to  be  HTML-based
  269.    as well as one-record per cell.
  270.  
  271. 
  272.